|
How to do screen dumps with Rockbox
Why screen dumps?
When writing the manual or wiki topics, it's always nice to include a screen shot. For web-use you should convert the image to PNG, which is best suited for this type of image (JPG will make it look blurry and BMP is uncompressed, and not supported by all browsers).
Taking screen shots on the real target
When the screendump function is enabled, it takes a snapshot of the LCD frame buffer each time you insert the USB connector. It will not enter USB mode, but instead save a BMP file.
To enable the screendump, select Menu->Info->Debug (keep out) ->Screendump. To disable it, select it again.
Taking screen shots in the Win32 simulator
Press the 0 key on the numeric keypad, or F5. The function is always enabled.
Taking screen shots in the X11 simulator
Press the 5 key. The function is always enabled.
File names
The screen dump files are stored in the root directory of the Rockbox unit..
If the unit has RTC (real-time clock), the files are named "YYYY-MM-DD HH-MM-SS.bmp" (YYYY=year, MM=month, DD=day, HH=hour, MM=minute, SS=second).
Otherwise, they are numbered sequentally, dump_0001.bmp etc.
Have fun!
|